home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 3 / Info_Mac_1994-01.iso / User Interface / General / MacMiNT / root.zoo / readme < prev   
Text File  |  1993-10-20  |  9KB  |  192 lines
  1. Oct 20, 1993
  2.  
  3. INTRODUCTION
  4.  
  5. MacMiNT is a port of MiNT from the Atari ST to the Macintosh.  MiNT is
  6. an enhanced version of the Atari OS TOS that supports many UNIX-like
  7. features.  Many free programs available on the net (GCC, tcsh, make,
  8. etc.) have been ported to MiNT.  MacMiNT can run nearly everything
  9. that MiNT can.  This software still has bugs though, so USE IT AT YOUR
  10. OWN RISK!
  11.  
  12. I have run MacMiNT on Macs ranging from the Portable to the Quadra.
  13. Please let me know if it doesn't work on your machine.  It might run
  14. on a Mac with 2M RAM, but it needs more like 8M if you want to run
  15. programs like GCC.  The default installation of MacMiNT requires about
  16. 12M of free disk space.  After installation, MacMiNT takes up about 7M
  17. of disk space.  You will probably end up using a lot more disk space
  18. when you start playing with other available programs.
  19.  
  20. MacMiNT is composed of 3 programs: 'MacMiNT', 'jet.prg' and
  21. 'mint.prg'.  The 'MacMiNT' application loads 'jet.prg'.  The file
  22. 'jet.prg' implements Just Enough TOS to support 'mint.prg'.  The file
  23. 'mint.prg' is the real MiNT program which has been slightly modified
  24. to work on the Macintosh.
  25.  
  26. The copyright, readme's, and documentation that came with the Atari
  27. distribution are in the 'mint095' directory.  Make sure you read and
  28. abide by the copyright information.  My additions to MiNT are neither
  29. copyrighted nor documented.  Because of the lack of documentation,
  30. MacMiNT is mainly useful to people who have UNIX experience.
  31.  
  32. The MacMiNT distribution contains only the minimum files needed to get
  33. started.  Many other files will need to be retrieved over the net
  34. before doing a complete installation.  MacMiNT stuff can be found at
  35. nic.switch.ch in /software/mac/src/macmint,
  36. suniams1.statistik.tu-muenchen.de in /incoming/MacMiNT, and at
  37. archive.cis.ohio-state.edu in /pub/mac-unix/macmint.  Mac software can
  38. be found at ftp.apple.com, sumex-aim.stanford.edu, and
  39. mac.archive.umich.edu.  Atari software can be found at
  40. atari.archive.umich.edu.  The Atari programs most likely to work under
  41. MacMiNT can be found under atari/Mint and atari/Gnustuff/Tos.
  42. The suniams1.statistik.tu-muenchen.de site is probably the most up
  43. to date site for MacMiNT stuff.
  44.  
  45. The default installation is somewhat optional.  If you are not sure
  46. what you are going to do with MacMiNT, you should manually install
  47. only the pieces that you want to play with.  If you are sure you want
  48. to develop programs using GCC, or you want to contribute to the
  49. development of MacMiNT then you should do the full installation.
  50.  
  51. INSTALLATION
  52.  
  53. You should have extracted the contents of the distribution archive and
  54. followed the instructions given there.
  55.  
  56. Get and install Macsbug.  MacMiNT still crashes and Macsbug helps you
  57. figure out why.
  58.  
  59. Get macgcc245b.zoo from a MacMiNT archive site and put it in your
  60. 'save' folder.  The 'save' folder should contain archives of various
  61. pieces of software that you might find useful.  Initially it contains
  62. archives of the source for MacMiNT and some of the programs that come
  63. with MacMiNT.  Most installation scripts expect to find the necessary
  64. archives in the 'save' folder.
  65.  
  66. Get the following files from an Atari archive site and put them in
  67. your 'save' folder:
  68. Mint/Gcc
  69.     bgas138p4.zoo
  70.     mgutil36.zoo
  71.     bmake363.zoo
  72. Mint/Lib
  73.     mntinc34.zoo
  74.     mntolb34.zoo
  75. Mint/Utilities
  76.     mperl.zoo
  77. Languages
  78.     slperl.zoo
  79.  
  80. Get the MPW 3.2 C Include files and put them into a folder called
  81. 'mpw' under your 'save' folder.  They come with MPW C, they can be
  82. ordered separately from APDA, and they are ftp-able from
  83. ftp.apple.com.  Be sure to read and abide by the copyright
  84. restrictions on ftp.apple.com.  Other versions of the C Include files
  85. may cause problems.
  86.  
  87. Edit 'profile.sh' (and 'cshrc.csh').  Change the 'TZ' variable to
  88. reflect your location (atleast change the 8 to the number of hours you
  89. are different from GMT).
  90.  
  91. Launch MacMiNT and run the default setup script.  This script removes
  92. and then installs the 'usr', 'mac', and 'src' directories.  If for
  93. some reason, you already have files in these directories, then be sure
  94. to move them somewhere else before running this script.  This script
  95. takes about 5 minutes on a Sun, 14 minutes on a Mac IIci with a 50MHz
  96. 68030, and longer than I want to wait on anything else.  The good
  97. thing is that it should only have to be run once.
  98. # /bin/sh setup/default.sh
  99.  
  100. At this point you should be ready to explore MacMiNT.
  101.  
  102. I strongly recommend installing tcsh, elvis, less, find, grep, diff,
  103. and patch.
  104. # /bin/sh setup/optional.sh
  105.  
  106. HINTS
  107.  
  108. Files used by MacMiNT should be in DOS or UNIX format in most
  109. circumstances (usually UNIX).  Be sure to turn on automatic LF
  110. conversion.  Many programs will not work correctly if certain files
  111. (i.e. 'mint.cnf') are not in the correct format.
  112.  
  113. Read what ever documentation you can find on GEMDOS and MiNT.  Most of
  114. the information should be true for MacMiNT.
  115.  
  116. MacMiNT uses traps 1, 13, 14 and also the TRACE exception vector.  This
  117. interferes with Macsbug.  Break points, single stepping, and some
  118. other Macsbug commands will not work properly when MacMiNT is active.
  119. Macsbug features like examining memory, that do not rely on these
  120. traps and exceptions, should work fine.
  121.  
  122. Starting with the command key down will cause MacMiNT to bring up a
  123. command line to enter arguments to be passed to mint.
  124.  
  125. Starting with the control key down will cause MacMiNT to enter the
  126. debugger, allowing break points to be set before mint gets started.
  127.  
  128. GDB doesn't work with MiNT 0.95.  This version of MacMiNT is based on
  129. MiNT 0.95, so GDB won't work.  GDB does work under the MacMiNT I will
  130. be distributing soon.  Because of copyright changes, MacMiNT based
  131. on more recent MiNT versions can only be distributed in source form.
  132.  
  133. The Mac filesystem is case insensitive, so commands like:
  134. 'mv makefile Makefile' will actually DELETE the file!
  135.  
  136. MiNT programs do not recognize the existence of the resource fork of
  137. a file.  Commands like 'cp Finder Finder.x' will only copy the data
  138. fork.  This is probably not what you would expect.  Also, symbolic
  139. links contain information in the resource fork, so they cannot be
  140. copied either.
  141.  
  142. Questions should be sent to the alt.mac.os@tazboy.jpl.nasa.gov mailing
  143. list.  The alt.mac.os mailing list is for the discussion of alternate
  144. operating systems for the macintosh.  This list should be a good place
  145. to discuss MacMiNT and other OS's like MacMach, MacLinux, MacBSD and
  146. MacMINIX.  Questions can also be sent to me directly at
  147. brad@tazboy.jpl.nasa.gov, but I would really appreciate it if you
  148. would try the mailing list first, so I don't get bogged down with
  149. "getting started" questions.  I will usually add your name to the
  150. mailing list if you send me a question about MacMiNT.  If I am too
  151. busy to answer the question, I will pass it along to the mailing list.
  152. If you wish to be added to or taken off the mailing list, let me know.
  153. You might also want to subscribe to comp.sys.atari.tech.
  154.  
  155. CONCLUSION
  156.  
  157. The source code is there for you to examine, fix, and enhance.  Please
  158. send me any changes you feel should be put in my distribution.  Please
  159. let me know if there is any other information that should be in this
  160. README.  I welcome suggestions on anything about MacMiNT but I make no
  161. guarantees.  If you have something MacMiNT related that you would like
  162. to share, contact Rainer Menes <menes@statistik.tu-muenchen.de> to see
  163. if it should be put in the 'contrib' directory on
  164. suniams1.statistik.tu-muenchen.de.
  165.  
  166. I really don't know how long I will continue to work on MacMiNT,
  167. probably until it gets boring to me.  I will almost certainly develop
  168. it until it is capable of reliably developing Mac programs using GCC.
  169. This should be long enough for others to get interested in MacMiNT and
  170. continue to support it if I decide to stop.  The need for MacMiNT will
  171. probably go away when other porting projects get finished, but this
  172. could be quite a long time.  I think that MacMiNT could serve as a
  173. good platform for porting X windows and maybe Mach for the Mac because
  174. it is similar to UNIX, where these products were originally developed.
  175. MacMiNT developed programs avoid many of the traditional barriers to
  176. porting UNIX code to the Mac, like segmentation and memory management.
  177.  
  178. Brad Pickering <brad@tazboy.jpl.nasa.gov>
  179.  
  180. PS - Thank you Eric Smith for writing a cool OS and making the sources
  181. freely available.
  182.  
  183. CONTRIBUTORS
  184. Rainer Menes <menes@statistik.tu-muenchen.de>
  185. Fred Grey <fgrey@cardinal.ncsc.org>
  186. Warren DeLano <warren@laplace.biology.yale.edu>
  187. Pete Keleher <pete@cs.rice.edu>
  188. Harry Eaton <haceaton@aplcomm.jhuapl.edu>
  189. Blair MacIntyre <bm@cs.columbia.edu>
  190.  
  191. (please let me know if your name should be here but it isn't)
  192.